home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libtelepathy-glib0 / README < prev   
Text File  |  2008-08-21  |  4KB  |  104 lines
  1. ==============
  2. telepathy-glib
  3. ==============
  4.  
  5. This is a library for GLib-based Telepathy components.
  6.  
  7. Telepathy is a D-Bus framework for unifying real time communication,
  8. including instant messaging, voice calls and video calls. It abstracts
  9. differences between protocols to provide a unified interface for
  10. applications.
  11.  
  12. Telepathy specification
  13. =======================
  14.  
  15. The copy of the Telepathy specification in the spec/ directory indicates
  16. the specification that this library claims to implement.
  17.  
  18. Requirements
  19. ============
  20.  
  21. Building telepathy-glib requires:
  22.   GLib, GObject <http://ftp.gnome.org/pub/GNOME/sources/glib/>
  23.   libdbus <http://dbus.freedesktop.org/releases/dbus/>
  24.   The D-Bus GLib bindings <http://dbus.freedesktop.org/releases/dbus-glib/>
  25.  
  26.   GNU make <http://www.gnu.org/software/make/>
  27.   pkg-config <http://ftp.gnome.org/pub/GNOME/sources/pkg-config/>
  28.   libxslt, xsltproc <http://xmlsoft.org/XSLT/>
  29.   Python <http://www.python.org/>
  30.  
  31. and can also make use of:
  32.   gtkdoc <http://ftp.gnome.org/pub/GNOME/sources/gtk-doc/>
  33.  
  34. See configure.ac for full details, including versions required.
  35. Of the packages listed above, only GLib, GObject, libdbus and dbus-glib are
  36. required at runtime.
  37.  
  38. Building from git also requires the GNU build system (Autoconf, Automake,
  39. libtool).
  40.  
  41. Bugs, feature requests and to-do list
  42. =====================================
  43.  
  44. Report all bugs, feature requests and "to-do" items here:
  45.   <https://bugs.freedesktop.org/enter_bug.cgi?product=Telepathy&component=telepathy-glib>
  46.  
  47. Running "make check" will produce FIXME.out, which lists all the mentions of
  48. FIXME, TODO or XXX in the source code. Ideally, all of these should be in
  49. Bugzilla, but sometimes they're not.
  50.  
  51. API stability policy
  52. ====================
  53.  
  54. We use an "odd/even" versioning scheme where the minor version (the y in
  55. x.y.z) determines stability - stable branches have y even, development
  56. branches have y odd.
  57.  
  58. In a stable (even) branch, we will not make incompatible API or ABI changes
  59. between one release tarball and the next.
  60.  
  61. In a development (odd) branch, if we make incompatible ABI changes
  62. between one release tarball and the next, we will change the SONAME of the
  63. library; we will attempt to avoid incompatible API or ABI changes.
  64.  
  65. Unreleased builds straight from git identify themselves as version
  66. "x.y.z.1". We DO NOT make any API guarantees about unreleased builds:
  67. any binary relying on new functionality from an unreleased build is not
  68. guaranteed to work with any subsequent release or unreleased build, and on
  69. platforms with versioned symbols (mainly Linux) it definitely won't work with
  70. subsequent releases (you'll have to at least relink the binary).
  71. We do not increment SONAMEs on the basis of unreleased changes.
  72.  
  73. Unreleased builds are compiled with -Werror, so they might stop working
  74. if your gcc version issues more warnings than ours. If this is a problem
  75. for you, use a release tarball.
  76.  
  77. Contact info
  78. ============
  79.  
  80. This library is maintained by the Telepathy project:
  81.   <http://telepathy.freedesktop.org/>
  82.   <mailto:telepathy@lists.freedesktop.org>
  83.   <irc://irc.freenode.net/telepathy>
  84.  
  85. Telepathy development is supported by Collabora Ltd.
  86.   <http://www.collabora.co.uk/>.
  87.  
  88. Hacking
  89. =======
  90.  
  91. The current development version of telepathy-glib is available from the
  92. 'master' branch in the git repository:
  93.   <git://git.collabora.co.uk/git/telepathy-glib.git>
  94.   <git+ssh://git.collabora.co.uk/git/telepathy-glib.git> (for committers)
  95.   <http://git.collabora.co.uk/?p=telepathy-glib.git> (gitweb)
  96.  
  97. Stable branches are available from branches with names like
  98. 'telepathy-glib-0.6' in the same repository.
  99.  
  100. Proposed patches awaiting review can usually be found in Merge Monkey:
  101.   <http://monkey.collabora.co.uk/>
  102.  
  103. Please follow <http://telepathy.freedesktop.org/wiki/Style>.
  104.